home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / STFX-soundsystemdisk.adf / docs / Controller.doc next >
Text File  |  1988-01-20  |  6KB  |  148 lines
  1.  --------------------------------------------------------------------------
  2.                     Sound Tracker Sound Controller V1.0
  3.        (C) copyright and written 1988 by Mr. Magic from THE PROPHETS AG
  4.               Translated in English by BOIL/JUNGLE COMMAND 
  5.  --------------------------------------------------------------------------
  6.  
  7. +------------------------------------------------------------+
  8. | Sound-Controller V1.0  (C) by Mr. Magic              XX XX | 
  9. | ---------------------------------------------------------- |
  10. | +--+ +-----------+ +-------+ +---------------------------+ |
  11. | | 0| |DF0:SONGS/ | |ST-01: | |                           | |
  12. | +--+ +---/-------+ +---/---+ +------/--------------------+ |
  13. | +--+    6             7    +--+    8     +---------------+ |
  14. | | 1| Begin Playing Sound in|4 |seconds   |Time:   9      | |
  15. | +--+                       +--+          +---------------+ |
  16. | +--+                                      +--+             |
  17. | | 2| Stop Playing Sound after starting in | 5|seconds      |
  18. | +--+                                      +--+             |
  19. | +--+                            +-----------------------+  |
  20. | | 3| Start/Stop Playing         |Remove Sound-Controller|  |
  21. | +--+                            +-----------------------+  |
  22. +------------------------------------------------------------+
  23.  
  24. Clarification Gadgets and Functions
  25. =========================================================================
  26. Nr. 0 : With this GadGet (Close-GadGet) you can remove SoundController
  27.         from the current screen, tough the Sound-Controller remains active.
  28.         With the HELP key you can get the Sound-Controller window back.
  29.     1 : When a song is loaded you must start it with this Gadget.
  30.         Only you will hear something if the TIME (4) is equal to TIME (9)
  31.         Choosing Gadget (1) will mark the Gadget with a 'x'
  32.     2 : The Song will stop when the TIME (5) is equal to TIME (9)
  33.         So you can controll with the right numbers in Gadget (4) and (5) 
  34.         the starting and ending point of the song.
  35.     3 : With this Gadget (3) you can turn the song on/off when you like
  36.         The song always plays, only not when Gadget (2) also is selected.
  37.         The sound stops then due to the filled in TIME (5), after 
  38.     selecting Gadget Nr.3 
  39.     4 : If you don't hear the song immediatly then you must correct the
  40.     TIME delay (0-999 Seconds). Don't forget to Click Function (1)
  41.     5 : This Gadget shows the TIME in which SONG is played and stopped
  42.     A little example:
  43.  
  44.     The song has to start in 20 sec, play for 60 sec and then stop.
  45.  
  46.     Then you fill in these numbers :
  47.  
  48.               BEGIN Playing Sound in 20 seconds
  49.               STOP  Playing Sound after starting in 60 seconds
  50.  
  51.            The Gadgets 2 and 1 must be selected!.
  52.            
  53.     The song waits for TIMER (9) to reach 20, then the song will be
  54.     played untill the TIMER reaches 80. (coz 80-20=60 stupid)
  55.     6 : This Gadget shows the PATH to load the SONGFILE (This is the file
  56.     saved by SOUNDTRACKER normally in the SONGS dir. of ST-00)
  57.     7 : This Gadget shows the PATH to load the INSTRUMENTS (These can be
  58.     found on the INSTRUMENTS DISK supplied along with SOUNDTRACKER
  59.     normally named ST-01 or higher!)
  60.     8 : This Gadget must contain the SONGNAME that must be loaded.
  61.     After pressing RETURN the Sound-Controller will try to load it.
  62.     When this fails you must check the PATH or the SONGNAME or simply
  63.     insert the RIGHT DISK.
  64.  
  65. Remove Sound-Controller: Exit Gadget closes Sound-Controller window and
  66.                          gives you the used memory back.
  67.  
  68.  
  69.  
  70. The Sound-Controller has to started from the CLI with the CLI-COMMAND
  71.      
  72.                'RUN C/SOUNDCONTROLL'
  73.  
  74.  
  75. This program you can use in combination with OWN Dia-Shows.
  76. To do that you have to program Sound-Controller which is easier than it
  77. sounds.
  78. You can program it just like the 'Startup-Sequence' only you must add a
  79. Parameter when calling Sound-Controller.
  80. For example:
  81.  
  82.             'RUN C/SOUNDCONTROLL S/SEQUENCE'
  83.  
  84. An example of a SEQUENCE which the Sound-Controller handles
  85.  
  86. STSC
  87. .SONG:DF0:SONGS/!
  88. .INST:ST-01:!
  89. .SFIL:DRUM-SOLO!
  90. .PLMO:1!
  91. .STAR:00!
  92. .STOP:300!
  93. END.
  94.  
  95. First the Sound-Controller needs to now that it is a Sequence-File.
  96. That is done in the beginning with the command 'STSC' (SoundTracker
  97. SoundController).
  98. Each line begins with an '.' then there comes a COMMAND which is
  99. ALWAYS 4 characters long followed with an ":" after that with NO spaces 
  100. the parameters closed with NO spaces and an "!" (Don't forget the "!"
  101. or errors will occure)
  102. The file is closed with 'END' (After that you can add some remarks which
  103. will be ignored.)
  104. The 'STAR'ttime and 'STOP'time is a decimal number from 00-999 and must
  105. be at least 2 (TWO!) characters !!!
  106.  
  107. Example: .STAR:06     ---> start after 6 Seconds
  108.          .STOP:09     ---> stop after 9 Seconds play
  109.  
  110. Also MUST the correct order of the commands be kept!!!!!
  111.  
  112. There are 4 PLMO (PLAYMODES)
  113.  
  114.   1 : The Song always plays (Untill the user stops it.)
  115.   2 : The Song plays untill the PLAYTIME is reached.  (.STOP:xxx) 
  116.   3 : The Song plays from startingtime (.STAR:xxx) untill stopped by user.
  117.   4 : The Song starts to play when the startingtime is reached and plays
  118.       untill the PLAYTIME is reached. (.STOP:xxx)
  119.  
  120. The Sound-Controller RUNS with no problems with Dia-Shows, Textediting,
  121. Copyprograms etc.
  122.  
  123. The Sound-Controller was developed & programmed by MR. MAGIC from 
  124. THE PROPHETS AG with use from the playroutine of Sound-Tracker V2.0
  125.  
  126. The Source-Code can be obtained by THE PROPHETS AG.
  127.  
  128. If you find ANY bugs in this program (I haven't found one) please notify
  129. me. I would be very grateful.
  130.  
  131. In the near future probably a UPDATE (with NEW?? Functions) will
  132. be available with THE PROPHETS AG ....
  133.  
  134.  
  135.                                            SIGNED Mr. Magic from THE PROPHETS
  136.  
  137.                                                                      HAVE FUN
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                         A Masterpiece by Mr. Magic
  145.  
  146.  
  147.  
  148.